home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / ghostscript / inst / ghostscript.manPage < prev    next >
Text File  |  1994-08-01  |  33KB  |  824 lines

  1.  
  2.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  3.  
  4.      NAME
  5.           gs - PostScript previewer
  6.  
  7.      SYNOPSIS
  8.           gs [ switches ] [ file1.ps file2.ps ... ]
  9.  
  10.      DESCRIPTION
  11.           Ghostscript is an interpreter for Adobe Systems' PostScript
  12.           (tm) language.  Gs reads each given file in sequence and
  13.           displays or prints it as a Ghostscript file.  It then
  14.           interprets commands from the primary input stream (normally
  15.           the keyboard) until an end of file character (^D or CTRL-D)
  16.           is typed.  Typing `quit' at the Ghostscript prompt also
  17.           terminates Ghostscript execution.  Typing the interrupt
  18.           character, e.g., control-C, also terminates Ghostscript
  19.           execution.
  20.  
  21.           You can get a help message by invoking Ghostscript with
  22.                gs -h
  23.           or
  24.                gs -?
  25.  
  26.         Choosing the output device
  27.           Ghostscript may be built with multiple output devices.
  28.           Ghostscript normally opens the first one and directs output
  29.           to it.  To use device xyz as the initial output device,
  30.           include the switch
  31.  
  32.                -sDEVICE=xyz
  33.  
  34.           in the command line.  Note that this switch must precede the
  35.           first .ps file, and only its first invocation has any
  36.           effect.  For example, for printer output in a normal
  37.           configuration that includes an Epson printer driver, you
  38.           might use the shell command
  39.  
  40.               gs -sDEVICE=epson myfile.ps
  41.  
  42.           instead of just
  43.  
  44.               gs myfile.ps
  45.  
  46.           Alternatively, you can type
  47.  
  48.               (epson) selectdevice
  49.  
  50.               (myfile.ps) run
  51.  
  52.           All output then goes to the printer instead of the display
  53.           until further notice.  You can switch devices at any time by
  54.           using the selectdevice procedure, e.g.,
  55.  
  56.      Page 1                                          (printed 4/15/93)
  57.  
  58.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  59.  
  60.               (vga) selectdevice
  61.  
  62.           or
  63.  
  64.               (epson) selectdevice
  65.  
  66.           As yet a third alternative, you can define an environment
  67.           variable GS_DEVICE as the desired default device name.  The
  68.           order of precedence for these alternatives, highest to
  69.           lowest, is:
  70.                          selectdevice
  71.                          (command line)
  72.                          GS_DEVICE
  73.                          (first device in build list)
  74.  
  75.           To select the density on a printer, use
  76.  
  77.                gs -sDEVICE=<device> -r<xres>x<yres>
  78.  
  79.           For example, on a 9-pin Epson-compatible printer, you can
  80.           get the lowest-density (fastest) mode with
  81.  
  82.                gs -sDEVICE=epson -r60x72
  83.  
  84.           and the highest-density mode with
  85.  
  86.                gs -sDEVICE=epson -r240x72.
  87.  
  88.           On a 24-pin printer, the lowest density is
  89.  
  90.                gs -sDEVICE=epson -r60x60
  91.  
  92.           and the highest-density 24-pin mode is
  93.  
  94.                gs -sDEVICE=epson -r360x180
  95.  
  96.           If you select a printer as the output device, Ghostscript
  97.           also allows you to control where the device sends its
  98.           output.  Normally, output goes directly to the printer (PRN)
  99.           on MS-DOS systems, and to a scratch file on Unix or VMS
  100.           systems.  To send the output to a series of files foo1.xyz,
  101.           foo2.xyz, ..., use the switch
  102.  
  103.                -sOutputFile=foo%d.xyz
  104.  
  105.           The %d is a printf format specification; you can use other
  106.           formats like %02d.  Each file will receive one page of
  107.           output.  Alternatively, to send the output to a single file
  108.           foo.xyz, with all the pages concatenated, use the switch
  109.  
  110.                -sOutputFile=foo.xyz
  111.  
  112.      Page 2                                          (printed 4/15/93)
  113.  
  114.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  115.  
  116.           On Unix systems, you can send the output directly to a pipe.
  117.           For example, to pipe the output to the command `lpr' (which,
  118.           on many Unix systems, is the command that spools output for
  119.           a printer), use the switch
  120.  
  121.                -sOutputFile=|lpr
  122.  
  123.           To find out what devices are available, type
  124.  
  125.               devicenames ==
  126.  
  127.           after starting up Ghostscript.  Alternatively you can use
  128.           the -h or -? switch in the command line, as described above.
  129.  
  130.         Device configuration
  131.           Ghostscript is normally configured to expect U.S. letter
  132.           paper, although there is a way to make A4 paper the default
  133.           for certain printers at compilation time (see devs.mak for
  134.           details).  To select a different paper size as the default,
  135.           use the switch
  136.  
  137.                -sPAPERSIZE=a_known_paper_size
  138.  
  139.           e.g.,
  140.  
  141.                -sPAPERSIZE=a4
  142.  
  143.           or
  144.  
  145.                -sPAPERSIZE=legal
  146.  
  147.           You can use any paper size listed in the table at the
  148.           beginning of gs_statd.ps.  (Individual documents can also
  149.           specify a paper size, which will take precedence over the
  150.           one specified on the command line.)
  151.  
  152.           Printing on a Hewlett-Packard DeskJet or LaserJet at full
  153.           resolution (300 DPI) requires a printer with at least 1.5 Mb
  154.           of memory.  150 DPI printing requires only .5 Mb.  You can
  155.           select 150 DPI printing with the command line switch
  156.  
  157.                -r150
  158.  
  159.           On MS-DOS systems using the Borland compiler, if Ghostscript
  160.           gives you a 'limitcheck in setdevice' error, it may mean
  161.           Ghostscript's standard buffer size wasn't large enough.
  162.           Likewise, if Ghostscript gives you a 'VMerror in setdevice'
  163.           error, it means the buffer size was too large.  You can use
  164.           the -dBufferSpace= switch to set the buffer size to a
  165.           different value, e.g.,
  166.  
  167.      Page 3                                          (printed 4/15/93)
  168.  
  169.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  170.  
  171.                -dBufferSpace=50000
  172.  
  173.           The default value is 25000; the smallest value Ghostscript
  174.           accepts is 10000; the largest valid value is 65000.
  175.  
  176.         File searching
  177.           When looking for the initialization files (gs_*.ps), the
  178.           files related to fonts, or the file for the 'run' operator,
  179.           Ghostscript first tries opening the file with the name as
  180.           given (i.e., using the current working directory if none is
  181.           specified).  If this fails, and the file name doesn't
  182.           specify an explicit directory or drive (i.e., doesn't begin
  183.           with '/' on Unix systems; doesn't contain a ':' or begin
  184.           with a '/' or '' on MS-DOS systems; doesn't contain a ':' or
  185.           a square bracket on VMS systems), Ghostscript will try
  186.           directories in the following order:
  187.  
  188.           -    The directory/ies specified by the -I switch(es) in the
  189.                command line (see below), if any;
  190.  
  191.           -    The directory/ies specified by the GS_LIB environment
  192.                variable, if any;
  193.  
  194.           -    The directories specified by the GS_LIB_DEFAULT macro,
  195.                which is typically set to
  196.                "/usr/lib/ghostscript:/usr/lib/ghostscript/fonts" at
  197.                compilation time in the Ghostscript makefile.
  198.  
  199.           Each of these (GS_LIB_DEFAULT, GS_LIB, and -I parameter) may
  200.           be either a single directory, or a list of directories
  201.           separated by a character appropriate for the operating
  202.           system (':' on Unix systems, ';' on VMS and MS-DOS systems).
  203.  
  204.         VMS-specific notes
  205.           On VMS systems, the last character of each "directory" name
  206.           indicates what sort of entity the "directory" references.
  207.           If the "directory" name ends with a colon, it is taken as
  208.           referring to a logical device, e.g.:
  209.                   $ DEFINE GHOSTSCRIPT_DEVICE DUA1:[GHOSTSCRIPT_14]
  210.                   $ DEFINE GS_LIB GHOSTSCRIPT_DEVICE:
  211.           If the "directory" name ends with a closing square bracket,
  212.           it is taken as referring to a real directory, e.g.:
  213.                   $ DEFINE GS_LIB DUA1:[GHOSTSCRIPT]
  214.  
  215.           To run Ghostscript with switches, you must type a command
  216.           like
  217.  
  218.                $ gs "-dNODISPLAY"
  219.  
  220.      Page 4                                          (printed 4/15/93)
  221.  
  222.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  223.  
  224.           because the C run time library will convert the command
  225.           parameters/arguments to lowercase unless you enclose them in
  226.           double quotes which preserves the case.
  227.  
  228.           If you are on an X Windows display (for which gs is built),
  229.           you can do
  230.  
  231.                $ set display/create/node="domain-name"/transport=tcpip
  232.  
  233.           For example,
  234.  
  235.                $ set display/create/node="doof.city.com"/transport=tcpip
  236.  
  237.           and then run Ghostscript
  238.  
  239.                $ gs
  240.  
  241.           If you write printer output to a file and then want to print
  242.           the file later, use the "/PASSALL" qualifier to the PRINT
  243.           command.
  244.  
  245.         MS-DOS notes
  246.           If you are running Ghostscript on a MS-DOS machine with a
  247.           display that is not EGA/VGA compatible, you must use the
  248.           Borland compiler.  You must build Ghostscript with the BGI
  249.           driver as the default, and you will need the appropriate
  250.           .BGI file from the Borland Turbo C library.  (Ghostscript
  251.           includes the EGA/VGA driver in the executable.)
  252.  
  253.           If you are using the BGI driver, two additional environment
  254.           variables become relevant:
  255.  
  256.           BGIPATH
  257.                defines the directory where Ghostscript will look for
  258.                the appropriate BGI driver.  If BGIPATH is not defined,
  259.                Ghostscript will look in the directory defined as
  260.                BGIDIR in the makefile.  In either case, if no driver
  261.                is found in the designated directory, Ghostscript will
  262.                look in the current directory.
  263.  
  264.           BGIUSER
  265.                a string of the form nn.dname, where nn is a
  266.                hexadecimal number giving a display mode and dname is
  267.                the name of a file containing a user-supplied BGI
  268.                driver.  If BGIUSER is defined and the BGI device is
  269.                selected, Ghostscript will supply nn as the display
  270.                mode and will obtain the driver from the file named
  271.                dname.
  272.  
  273.                Some applications, such as Microsoft Word, require a
  274.  
  275.      Page 5                                          (printed 4/15/93)
  276.  
  277.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  278.  
  279.                prologue in front of the PostScript files they output.
  280.                In the case of Word, this is one of the *.ini files
  281.                included with the Word distribution.  Other
  282.                applications may require other prologues.  These may be
  283.                specified on the Ghostscript command line, e.g.,
  284.                     gs prologue.ini myfile.ps
  285.  
  286.         X Windows resources
  287.           Ghostscript looks for the following resources under the
  288.           program name ``Ghostscript'':
  289.  
  290.           borderWidth
  291.                the border width in pixels (default = 1)
  292.  
  293.           borderColor
  294.                the name of the border color (default = black)
  295.  
  296.           geometry
  297.                the window size and placement, WxH+X+Y (default = ???)
  298.  
  299.           xResolution
  300.                the number of x pixels per inch default is computed
  301.                from WidthOfScreen and WidthMMOfScreen
  302.  
  303.           yResolution
  304.                the number of y pixels per inch default is computed
  305.                from HeightOfScreen and HeightMMOfScreen
  306.  
  307.                To set these resources, put them in a file (such as
  308.                ~/.Xdefaults in X11R3 or ~/.Xresources in X11R4 or
  309.                X11R5) in the following form:
  310.  
  311.                    Ghostscript*geometry: 612x792-0+0
  312.                    Ghostscript*xResolution: 72
  313.                    Ghostscript*yResolution: 72
  314.  
  315.                Then load the defaults into the X server:
  316.  
  317.                % xrdb -merge ~/.Xresources
  318.  
  319.      OPTIONS
  320.           The interpreter recognizes several switches described below,
  321.           which may appear anywhere in the command line and apply to
  322.           all files thereafter.
  323.  
  324.         Normal switches
  325.           @filename
  326.  
  327.      Page 6                                          (printed 4/15/93)
  328.  
  329.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  330.  
  331.                Causes Ghostscript to read filename and treat its
  332.                contents the same as the command line.  (This is
  333.                intended primarily for getting around DOS' 128-
  334.                character limit on the length of a command line.)
  335.                Switches or file names in the file may be separated by
  336.                any amount of white space (space, tab, line break);
  337.                there is no limit on the size of the file.
  338.  
  339.           -- filename arg1 ...
  340.                Takes the next argument as a file name as usual, but
  341.                takes all remaining arguments (even if they have the
  342.                syntactic form of switches) and defines the name
  343.                ARGUMENTS in userdict (not systemdict) as an array of
  344.                those strings, *before* running the file.  When
  345.                Ghostscript finishes executing the file, it exits back
  346.                to the shell.
  347.  
  348.           -Dname=token
  349.  
  350.           -dname=token
  351.                Define a name in systemdict with the given definition.
  352.                The token must be exactly one token (as defined by the
  353.                `token' operator) and must not contain any whitespace.
  354.  
  355.           -Dname
  356.  
  357.           -dname
  358.                Define a name in systemdict with value=null.
  359.  
  360.           -Sname=string
  361.  
  362.           -sname=string
  363.                Define a name in systemdict with a given string as
  364.                value.  This is different from -d.  For example,
  365.                       -dname=35
  366.           is equivalent to the program fragment
  367.                       /name 35 def
  368.           whereas
  369.                       -sname=35
  370.           is equivalent to
  371.                       /name (35) def
  372.  
  373.           -q   Quiet startup -- suppress normal startup messages, and
  374.                also do the equivalent of -dQUIET.
  375.  
  376.           -gnumber1xnumber2
  377.                Equivalent to -dDEVICEWIDTH=number1 and
  378.  
  379.      Page 7                                          (printed 4/15/93)
  380.  
  381.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  382.  
  383.                -dDEVICEHEIGHT=number2.  This is for the benefit of
  384.                devices (such as X11 windows and VESA displays) that
  385.                require (or allow) width and height to be specified.
  386.  
  387.           -rnumber1xnumber2
  388.                Equivalent to -dDEVICEXRESOLUTION=number1 and
  389.                -dDEVICEYRESOLUTION=number2.  This is for the benefit
  390.                of devices (such as printers) that support multiple X
  391.                and Y resolutions.
  392.  
  393.           -Idirectories
  394.                Adds the designated list of directories at the head of
  395.                the search path for library files.
  396.  
  397.           -     This is not really a switch.  It indicates to
  398.                Ghostscript that the standard input is coming from a
  399.                file or a pipe.  Ghostscript reads from stdin until
  400.                reaching end-of-file, executing it like any other file,
  401.                and then continues processing the command line.  At the
  402.                end of the command line, Ghostscript exits rather than
  403.                going into its interactive mode.
  404.  
  405.           Note that gs_init.ps makes systemdict read-only, so the
  406.           values of names defined with -D/d/S/s cannot be changed
  407.           (although, of course, they can be superseded by definitions
  408.           in userdict or other dictionaries.)
  409.  
  410.         Special names
  411.           -dDISKFONTS
  412.                causes individual character outlines to be loaded from
  413.                the disk the first time they are encountered.
  414.                (Normally Ghostscript loads all the character outlines
  415.                when it loads a font.)  This may allow loading more
  416.                fonts into RAM, at the expense of slower rendering.
  417.  
  418.           -dNOBIND
  419.                disables the `bind' operator.  Only useful for
  420.                debugging.
  421.  
  422.           -dNOCACHE
  423.                disables character caching.  Only useful for debugging.
  424.  
  425.           -dNODISPLAY
  426.                suppress the normal initialization of the output
  427.  
  428.      Page 8                                          (printed 4/15/93)
  429.  
  430.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  431.  
  432.                device.  This may be useful when debugging.
  433.  
  434.           -dNOPAUSE
  435.                disables the prompt and pause at the end of each page.
  436.                This may be desirable for applications where another
  437.                program is 'driving' Ghostscript.
  438.  
  439.           -dSAFER
  440.                disables the deletefile and renamefile operators, and
  441.                the ability to open files in any mode other than read-
  442.                only.  This may be desirable for spoolers or other
  443.                sensitive environments.
  444.  
  445.           -dWRITESYSTEMDICT
  446.                leaves systemdict writable.  This is necessary when
  447.                running special utility programs such as font2c and
  448.                pcharstr, which must bypass normal PostScript access
  449.                protection.
  450.  
  451.           -sDEVICE=device
  452.                selects an alternate initial output device, as
  453.                described above.
  454.  
  455.           -sOutputFile=filename
  456.                selects an alternate output file (or pipe) for the
  457.                initial output device, as described above.
  458.  
  459.         Debugging switches
  460.           The -T and -Z switch only applies if the interpreter was
  461.           built for a debugging configuration (this is usually not the
  462.           case for Ghostscript executables installed for public use).
  463.  
  464.           -A   Turn on allocator debugging.
  465.  
  466.           -e   Turn on tracing of error returns from operators.
  467.  
  468.           -E   Abort when any operator returns with an error.
  469.  
  470.           -Mn  Force the interpreter's allocator to acquire additional
  471.                memory in units of nK, rather than the default
  472.                (currently 20K on MS-DOS systems, 50K on Unix).  n is a
  473.                positive decimal integer (not exceeding 63 on MS-DOS
  474.  
  475.      Page 9                                          (printed 4/15/93)
  476.  
  477.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  478.  
  479.                systems).
  480.  
  481.           -Zxxx
  482.                Turn on debugging printout.  Each of the xxx characters
  483.                selects an option:  if the string is empty, all options
  484.                are selected.  Case is significant.
  485.                        1 = type 1 font interpreter (type1addpath)
  486.                        2 = curve subdivider/rasterizer
  487.                        a = allocator (large blocks only)
  488.                        A = allocator (all calls)
  489.                        b = bitmap image processor
  490.                        B = bitmap images, detail
  491.                        c = color/halftone mapper
  492.                        d = dictionary put/undef
  493.                        f = fill algorithm (summary)
  494.                        F = fill algorithm (detail)
  495.                        g = gsave/grestore[all]
  496.                        h = halftone renderer
  497.                        i = interpreter, just names
  498.                        I = interpreter, everything
  499.                        k = character cache
  500.                        K = character cache, every access
  501.                        l = command lists, bands
  502.                        L = command lists, everything
  503.                        m = makefont and font cache
  504.                        n = name lookup (new names only)
  505.                        o = outliner (stroke)
  506.                        p = path tracer
  507.                        q = rectangle fill
  508.                        r = arc renderer
  509.                        s = scanner
  510.                        t = tiling algorithm
  511.                        u = undo saver (for save/restore)
  512.                        U = undo saver, more detail
  513.                        v = rectangle fill
  514.                        V = device-level output
  515.                        w = compression encoder/decoder
  516.                        x = transformations
  517.                        z = trapezoid fill
  518.  
  519.      EXAMPLES
  520.                spam% gs
  521.                 Initializing... done.
  522.                 Ghostscript 2.5.2 (9/19/92)
  523.                   Copyright (C) 1990, 1992 Aladdin Enterprises, Menlo Park, CA.
  524.                   All rights reserved.
  525.                 Distributed by Free Software Foundation, Inc.
  526.                 Ghostscript comes with NO WARRANTY: see the file LICENSE for details.
  527.                 GS> 100 100 moveto 200 400 lineto stroke
  528.                 GS> erasepage
  529.  
  530.      Page 10                                         (printed 4/15/93)
  531.  
  532.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  533.  
  534.                 GS> (/usr/um/lib/ghostscript/tiger.ps) run
  535.                 >>showpage, press <return> to continue<<
  536.                 GS> quit
  537.  
  538.      Unix  NOTES
  539.           At most installations, the only available display device is
  540.           x11, so you must be running X11 windows to use ghostscript
  541.           unless you use the command line option -dNODISPLAY.  There
  542.           is also a script called 'gsnd' which is just 'gs -DNODISPLAY
  543.           -q $*'.
  544.  
  545.           At most installations, Ghostscript was not built for a
  546.           debugging configuration therefore the command line option
  547.           -Zxxx is not available.  This speeds up the interpreter.
  548.  
  549.           Ghostscript works with color postscript files, postscript
  550.           files created by Tom Rokicki's dvips, M-PLOT, Mathematica,
  551.           Tell-a-Graf, etc.  You can, for example, preview multiple
  552.           pages of a postscript file created by Latex/dvips/psfig and
  553.           you will be able to see any included postscript figure.  If
  554.           the postscript file adheres to Adobe's Document Structuring
  555.           Convention, like the ones generated by Latex/dvips, then you
  556.           are advised to use ghostview to preview your postscript
  557.           document for it provides a far more friendly and graphical
  558.           user interface.
  559.  
  560.           Ghostscript also has the ability to convert a postscript
  561.           file to a PPM file.  Once you have a file in PPM format you
  562.           can display or manipulate it in many ways.  You can, for
  563.           example, use 'xv' or other tools to convert the PPM file to
  564.           a variety of formats, like GIF, TIFF, PICT, RLE, XPM, GPR
  565.           (only available on the apollos, through the program
  566.           /progs/bit2bit/bin/ppm2gpr) etc.
  567.  
  568.           Example:
  569.                 spam% gs
  570.                 Initializing... done.
  571.                 Ghostscript 2.5.2 (9/19/92)
  572.                   Copyright (C) 1990, 1992 Aladdin Enterprises, Menlo Park, CA.
  573.                   All rights reserved.
  574.                 Distributed by Free Software Foundation, Inc.
  575.                 Ghostscript comes with NO WARRANTY: see the file LICENSE for details.
  576.                 GS> (pstoppm.ps) run
  577.                 Usage: (file) ppmNrun
  578.                    converts file.ps to file.ppm (single page),
  579.                      or file.1ppm, file.2ppm, ... (multi page).
  580.                    N is # of bits per pixel (1, 8, or 24).
  581.                 Examples: (golfer) ppm1run   ..or..   (escher) ppm8run
  582.                 Optional commands you can give first:
  583.                    horiz_DPI vert_DPI ppmsetdensity
  584.                    (dirname/) ppmsetprefix
  585.  
  586.      Page 11                                         (printed 4/15/93)
  587.  
  588.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  589.  
  590.                    page_num ppmsetfirstpagenumber
  591.                 GS> 100 120 ppmsetdensity
  592.                 GS> (/tmp/) ppmsetprefix
  593.                 GS> (tiger) ppm24run
  594.                 Writing /tmp/tiger.ppm
  595.                 GS> quit
  596.  
  597.                 spam% ppmtogif < /tmp/tiger.ppm > /tmp/tiger.gif
  598.                 ppmtogif: computing colormap...
  599.                 ppmtogif: 39 colors found
  600.  
  601.                 spam% ls -l tiger.ps /tmp/tiger.ppm /tmp/tiger.gif
  602.                 -rw-r--r--   1 oliveria    41796 Apr 21 18:44 /tmp/tiger.gif
  603.                 -rw-r--r--   1 oliveria  3366054 Apr 21 18:36 /tmp/tiger.ppm
  604.                 -rw-r--r--   1 oliveria    78519 Apr 21 17:39 tiger.ps
  605.  
  606.           Notice that ppm24run creates huge files.
  607.  
  608.           IslandDraw version 3.0 or greater is also able to read
  609.           (select 'Convert...'  under the 'File' menu) single-page
  610.           postscript files.  It can also save the postscript file in a
  611.           variety of formats.
  612.  
  613.      SYSTEM FILES
  614.           gs_init.ps     Ghostscript reads this automatically when it
  615.                          starts up.  It contains definitions of many
  616.                          standard procedures and initialization for a
  617.                          wide variety of things.
  618.  
  619.           gs_fonts.ps    Font initialization.  gs_init.ps reads this
  620.                          in.  It initializes Ghostscript's font
  621.                          machinery and provides some utility
  622.                          procedures that work with fonts.
  623.  
  624.           gs_statd.ps    gs_init.ps reads this in.  It creates a dummy
  625.                          statusdict and some other environmental odds
  626.                          and ends for the benefit of P*stScr*pt files
  627.                          that really want to be printed on a
  628.                          LaserWriter.
  629.  
  630.           gs_2asc.ps     This utility file helps extract the ASCII
  631.                          text from PostScript source files.  It
  632.                          redefines many operators.  For more
  633.                          information, see the comments in the file.
  634.  
  635.           gs_dps1.ps     gs_init.ps reads this in if the dps feature
  636.                          is included in the configuration.  It
  637.                          provides support for various Display
  638.                          PostScript and Level 2 features.
  639.  
  640.           sym__enc.ps    the Symbol encoding, loaded only if
  641.  
  642.      Page 12                                         (printed 4/15/93)
  643.  
  644.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  645.  
  646.                          referenced.
  647.  
  648.      ART
  649.           chess.ps       a black-and-white chessboard.
  650.  
  651.           golfer.ps      a gray-scale picture of a stylishly dressed
  652.                          woman swinging a golf club.
  653.  
  654.           escher.ps      a colored version of a hexagonally symmetric
  655.                          Escher drawing of interlocking butterflies.
  656.                          Can be printed on monochrome devices, with
  657.                          somewhat less dramatic results.
  658.  
  659.           cheq.ps        a chessboard "font" used by chess.ps
  660.                          (obtained from the Adobe file server).
  661.  
  662.           snowflak.ps    a rectangular grid of intricate colored
  663.                          snowflakes.  (Renders very slowly.)
  664.  
  665.           colorcir.ps    a set of nested ellipses made up of colored
  666.                          bars.
  667.  
  668.           tiger.ps       a dramatic colored picture of a tiger's head.
  669.  
  670.      UTILITIES
  671.           bdftops.ps     a utility for converting BDF fonts to outline
  672.                          form.
  673.  
  674.           decrypt.ps     a utility for decrypting the eexec section of
  675.                          a font.
  676.  
  677.           gslp.ps        a utility for doing "line printing" of plain
  678.                          text files.
  679.  
  680.           impath.ps      a utility for reconstructing outlines from
  681.                          bitmap images, used by bdftops.
  682.  
  683.           landscap.ps    a file that you can put in front of your own
  684.                          files to get them rendered in landscape mode.
  685.  
  686.           pstoppm.ps     a utility for rendering PostScript files onto
  687.                          PPM (bitmap) files.
  688.  
  689.           ps2image.ps    a utility for converting an arbitrary
  690.                          PostScript file into a PostScript file
  691.                          consisting of just bitmaps, one per page.
  692.  
  693.           wrfont.ps      a utility for writing out an unprotected Type
  694.                          1 font, such as the standard Ghostscript
  695.                          fonts.
  696.  
  697.      Page 13                                         (printed 4/15/93)
  698.  
  699.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  700.  
  701.      ODDS and ENDS
  702.           empty.ps       an empty file.
  703.  
  704.           lines.ps       a test program for line joins and caps.
  705.  
  706.           pcharstr.ps    a program to print out the CharStrings and
  707.                          Subrs in a Type 1 font.
  708.  
  709.           ppath.ps       a couple of utilities for printing out the
  710.                          current path, for debugging.
  711.  
  712.           prfont.ps      a program to print a font catalog.
  713.  
  714.           quit.ps        a file containing just the word "quit".
  715.  
  716.           traceop.ps     a memory usage monitor for debugging.
  717.  
  718.           type1ops.ps    the Type 1 font format opcodes.
  719.  
  720.           unprot.ps      a program to disable access checking.
  721.  
  722.      FILES
  723.           Fontmap        A catalog of fonts known to gs. Lists the
  724.                          GhostScript name, corresponding font file
  725.                          name, font encoding and font identification
  726.                          number for each font that gs knows.
  727.  
  728.           /usr/um/lib/ghostscript
  729.                          Initialization files, utilities, sample
  730.                          postscript files
  731.  
  732.           /usr/um/lib/ghostscript/fonts
  733.                          Ghostscript and Hershey fonts (*.gsf files)
  734.  
  735.      KNOWN PROBLEMS
  736.           The interactive interpreter requires that every statement
  737.           fit on a line, i.e., you can't have an unpaired ( or {.
  738.  
  739.           On a MS-DOS system, interrupting Ghostscript by typing ^C
  740.           doesn't restore the display mode.
  741.  
  742.           The Ghostscript language does not include the following
  743.           operators of the PostScript language:
  744.                resetfile
  745.                banddevice, renderbands
  746.  
  747.           The following are not implemented completely:
  748.                %statementedit (file name): interpreted as equivalent to
  749.           %lineedit.
  750.  
  751.      Page 14                                         (printed 4/15/93)
  752.  
  753.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  754.  
  755.           Most of the new color operators, particularly those that
  756.           support the CMYK color model, are implemented as Ghostscript
  757.           language procedures, and they essentially emulate CMYK using
  758.           RGB.
  759.  
  760.           The following operators that expect arrays won't accept
  761.           packed arrays:
  762.                definefont (Subrs (type 1 fonts))
  763.                setdash (dash pattern)
  764.                setcachedevice (bounding box)
  765.                makeimagedevice (palette)
  766.  
  767.           The file operator only recognizes modes r and w, not the
  768.           newer modes r+, w+, a, and a+.
  769.  
  770.           Floating point exceptions terminate Ghostscript, rather than
  771.           producing a rangecheck error.
  772.  
  773.           Some access checks aren't implemented.
  774.  
  775.           copypage does nothing in the MS-DOS implementation, and
  776.           merely synchronizes the X connection in the Unix
  777.           implementation.  showpage is a procedure that does a
  778.           copypage and then beeps the bell and waits for the user to
  779.           hit a key.  (copypage does do the right thing for printers.)
  780.  
  781.           strokepath produces incorrect output for dashed lines.
  782.  
  783.           The implementation only looks at the PaintType of the font
  784.           when doing show, not when doing charpath.  Because of this,
  785.           stroked fonts don't work correctly with charpath.
  786.  
  787.           arcto gives an error for negative radii.
  788.  
  789.           Changing the contents of the Encoding array or the Metrics
  790.           dictionary of a font dynamically doesn't produce the
  791.           expected result (may have no effect) if character caching is
  792.           enabled.
  793.  
  794.           Halftone patterns "flip over" at the 50% coverage point,
  795.           producing anomalous visual effects on some color devices.
  796.  
  797.           We have not been able to test 2-, 4-, and 16-bit memory
  798.           devices as thoroughly as 1-, 8-, 24-, and 32-bit devices;
  799.           please report any problems.
  800.  
  801.           Opening more than one window device at the same time doesn't
  802.           work.  This is the case for both X Windows and Microsoft
  803.           Windows.
  804.  
  805.           restore doesn't properly undo currentgstate.
  806.  
  807.      Page 15                                         (printed 4/15/93)
  808.  
  809.      GS(1)            UNIX System V (August 16, 1992)            GS(1)
  810.  
  811.           copy doesn't handle gstates.
  812.  
  813.      BUGS
  814.           See the netnews group ``gnu.ghostscript.bug'' for more
  815.           information.
  816.  
  817.      SEE ALSO
  818.           The PostScript Language Reference Manual, Adobe Systems
  819.           Incorporated, Second Edition, Addison-Wesley Publishing
  820.           Company, ISBN 0-201-18127-4, 1990
  821.           X(1), ghostview(1), lpr(1), dvips(1), ppm(5), xv(1)
  822.  
  823.      Page 16                                         (printed 4/15/93)
  824.